NAME¶

cache_check - validates cache metadata on a device or file.

SYNOPSIS¶

cache_check [options] {device|file}

DESCRIPTION¶

cache_check checks cache metadata created by the device-mapper cache target on a device or file.

This tool cannot be run on live metadata.

OPTIONS¶

-h, --help

Print help and exit.

-V, --version

Output version information and exit.

-q, --quiet

Suppress output messages, return only exit code.

--super-block-only

Only check the superblock.

--skip-hints

Skip checking of the policy hint values metadata.

--skip-discards

Skip checking of the discard bits in the metadata.

--clear-needs-check-flag

Clears the 'needs_check' flag in the superblock.

    The kernel may set a flag to force the pool to be checked before it's next


    activated.  Set this switch to clear the flag if the check is successful.


    If the metadata check failed, the flag is not cleared and a cache_repair run


    is needed to fix any issues. After cache_repair succeeded, you may run


    cache_check again.

EXAMPLE¶

Analyses and repairs cache metadata on logical volume /dev/vg/metadata:

    $ cache_check /dev/vg/metadata

DIAGNOSTICS¶

cache_check returns an exit code of 0 for success or 1 for error.

SEE ALSO¶

cache_dump(8), cache_repair(8), cache_restore(8)

AUTHOR¶

Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>